package snuvm.assemblerARM9;

import java.util.ArrayList;

/*
Copyright (c) 2009-2010,  Jeongho Nah, Gangwon Jo, Jaejin Lee

Developed by 
	Jeongho Nah (jeongho"at"aces.snu.ac.kr)
	Gangwon Jo (gangwon"at"aces.snu.ac.kr)
	Jaejin Lee (jlee"at"cse.snu.ac.kr)


Permission is hereby granted to use this version of the code 
under the same terms as MARS, which has the following license:

--
Copyright (c) 2003-2008,  Pete Sanderson and Kenneth Vollmar

Developed by Pete Sanderson (psanderson"at"otterbein.edu)
and Kenneth Vollmar (kenvollmar"at"missouristate.edu)

Permission is hereby granted, free of charge, to any person obtaining 
a copy of this software and associated documentation files (the 
"Software"), to deal in the Software without restriction, including 
without limitation the rights to use, copy, modify, merge, publish, 
distribute, sublicense, and/or sell copies of the Software, and to 
permit persons to whom the Software is furnished to do so, subject 
to the following conditions:

The above copyright notice and this permission notice shall be 
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR 
ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF 
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

(MIT license, http://www.opensource.org/licenses/mit-license.html)
 */

/**
 * Represents the list of tokens in a single line of MIPS code.  It uses, but is not
 * a subclass of, ArrayList.
 * 
 * @author Pete Sanderson 
 * @version August 2003
 */

public class TokenList implements Cloneable {
	// instance variables - replace the example below with your own
	private ArrayList tokenList;

	/**
	 * Constructor for objects of class TokenList
	 */
	public TokenList() {
        tokenList = new ArrayList();
	}

	/**
	 * Returns requested token given position number (starting at 0).
	 * 
	 * @param  pos   Position in token list.
	 * @return     the requested token, or ArrayIndexOutOfBounds exception 
	 */
    public Token get(int pos) {
        return (Token) tokenList.get(pos);
    }

	/**
	 * Returns number of tokens in list.
	 * 
	 * @return  token count. 
	 */    
    public int size() {
        return tokenList.size();
    }

	/**
	 * Adds a Token object to the end of the list.
	 * 
	 * @param  token   Token object to be added.
	 */    
    public void add(Token token) {
        tokenList.add(token);
    }

	/**
	 * Removes Token object at specified list position. Uses ArrayList remove method.
	 * 
	 * @param  pos   Position in token list.  Subsequent Tokens are shifted one position left.
	 * @throws IndexOutOfBoundsException if <tt>pos</tt> is < 0 or >= <tt>size()</tt>
	 */    
    public void remove(int pos) {
        tokenList.remove(pos);
    }

	/**
	 * Returns empty/non-empty status of list.
	 * 
	 * @return     <tt>true</tt> if list has no tokens, else <tt>false</tt>. 
	 */    
    public boolean isEmpty() {
        return tokenList.isEmpty();
    }

	/**
	 * Get a String representing the token list.
	 * 
	 * @return     String version of the token list 
	 * (a blank is inserted after each token). 
	 */
	     
	 public String toString() {
	    String stringified = "";
		 for (int i=0; i<tokenList.size(); i++) {
		   stringified += tokenList.get(i).toString()+" ";
		 }
		 return stringified;
	}
	/**
	 * Makes clone (shallow copy) of this token list object.
	 * 
	 * @return     the cloned list. 
	 */
	// Clones are a bit tricky.  super.clone() handles primitives (e.g. values) correctly
	// but the ArrayList itself has to be cloned separately -- otherwise clone will have
	// alias to original token list!!
    public Object clone() {
        try {
            TokenList t = (TokenList) super.clone();
            t.tokenList = (ArrayList) tokenList.clone();
            return t;
        } catch (CloneNotSupportedException e) {
            return null;
        }
    }
}
